home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / FILER / CLICBACK.ZIP / ClicBack / !ClicBack² / !Help < prev    next >
Text File  |  1996-11-09  |  32KB  |  760 lines
  1.                                !ClicBack
  2.                        Hard Disk Backup Utilities
  3.                              Version 2.8
  4.                             © Steve Spry 1995.
  5.  
  6. Please note that this application is NOT Public Domain, it is 
  7.  
  8.  
  9.           CCCCC   AAAA   RRRRR   EEEEEE  WW   WW  AAAA   RRRRR   EEEEEE
  10.         CC       AA  AA  RR  RR  EE      WW   WW AA  AA  RR  RR  EE
  11.         CC       AA  AA  RR  RR  EE      WW W WW AA  AA  RR  RR  EE
  12.         CC       AAAAAA  RRRRR   EEEEE   WW W WW AAAAAA  RRRRR   EEEEE
  13.         CC       AA  AA  RR RR   EE      WWWWWWW AA  AA  RR RR   EE
  14.         CC       AA  AA  RR  RR  EE      WWW WWW AA  AA  RR  RR  EE
  15.           CCCCC  AA  AA  RR  RR  EEEEEE  WW   WW AA  AA  RR  RR  EEEEEE
  16.  
  17. It is NOT free software.
  18.  
  19. Permission is hereby granted to allow any person, group, body, or company to
  20. use this program, subject to the following terms :
  21.  
  22.  
  23.   1. The program is supplied "as is", without express or implied warranty.
  24.      No representations are made about the suitability of this software for
  25.      any purpose.
  26.      
  27.   2. This version of the program is CAREWARE, as such continued use
  28.      requires registration (see below).
  29.      
  30.   3. The author reserves the right to refuse any person, or company,
  31.      permission to use this program.
  32.      
  33.   4. The unregistered version of the program maybe freely distributed
  34.      and a small charge made for the copying and postage etc.  This
  35.      'fee' should not exceed £2.
  36.  
  37. !ClicBack Utilities are CAREWARE and NOT PUBLIC DOMAIN. 
  38. This means that the proceeds are given to charity.In the case of these 
  39. programs the charity is CLIC,The Cancer & Leukaemia In Childhood 
  40. Trust, registered charity number 802396.
  41. If, after a period of 30 days, you find the program useful you are 
  42. required to register your copy of the programs for a fee of £10.  This 
  43. payment will entitle you to the "Key" file which will remove the banner 
  44. file and put your name into the Info box. As a registered user you will
  45. also be entitled to free technical support.
  46. To register your copy of the programs please send a cheque or postal 
  47. orders made payable to Steve Spry and a blank 800K disk (without a lable
  48. as I will put on a nice coloured on for you) to:
  49.  
  50.                   Steve Spry
  51.                   36 Moreton Avenue
  52.                   Bideford
  53.                   North Devon
  54.                   EX39 3AY
  55.                   EMail : ClicBack@sprigo.demon.co.uk
  56.  
  57. If you could also inform me as to which version of RISCOS you 
  58. have, the amount of memory you have, the processor and the size of 
  59. your hard disk it would help me to develop the program further.
  60. If you want to send any PD programs etc please feel free to do so.
  61. Like wise if you mention what you are interested in I will attempt
  62. to add some PD to the returned disc.
  63.  
  64.  
  65. Background
  66. ~~~~~~~~~~
  67. This program had been sitting on my hard disk for nearly three years 
  68. in a half finished state whilst I played around with data compression 
  69. techniques. 
  70. Following the death of my five year old son from a brain tumour in 
  71. January 1993 I decided to finish this program and donate the proceeds 
  72. to CLIC.  As the program progressed more and more features were 
  73. added or changed. Even now there are things that I would like to 
  74. change but I could carry on for ever.
  75.  
  76. This program is dedicated to his memory and all those brave young 
  77. children fighting all forms of cancer.For there sake, if you like the 
  78. program, please register your copy of the program.
  79.  
  80. Further details about CLIC can be obtained from:
  81.  
  82.                   12-13 King Square,
  83.                   Bristol,
  84.                   BS2 8JH
  85.                   Tel: 0117 9248844
  86.                   Fax: 0117 9244505  
  87.  
  88.  
  89. Introduction
  90. ~~~~~~~~~~~~
  91. The main features of the programs include :
  92. • Full, Differential and Incremental backups.
  93. • Selective option to preserve history integrity
  94. • Backup to floppies or another hard disk.
  95. • Backup only specified directories or files.
  96. • Exclude any files or directories from the backup.
  97. • Verify whilst backing up.
  98. • Password protection for added security.
  99. • 32 bit CRC
  100. • Restore data to any directory.
  101. • Powerful searching facility to locate Files / Directories or
  102.   Applications within backup data.
  103. • Ability to restore whole directories or applications.
  104. • Variable data compression.
  105. • Estimate number of floppy disks required.
  106. • Estimate time required to complete backup.
  107. • Save settings as configuration files.
  108. • Customisation file.
  109. • Acorn’s Interactive help supported.
  110.  
  111.  
  112. Getting Started
  113. ~~~~~~~~~~~~~~~
  114. First copy the program to a directory on your hard disc.
  115.  
  116. To load the program double click on the !ClicBack 
  117. icon.The program will be loaded and the !ClicBack icon 
  118. will be displayed on the right hand side of the iconbar.  If 
  119. the program has not been registered a banner will be 
  120. displayed reminding you that the program is Careware 
  121. and of your obligation to do this.  Before you can proceed any further 
  122. with the program you will have to click on the "Un-Registered" icon.  
  123. This will remove the banner and unlock the program.
  124.  
  125. Iconbar Menu
  126. ~~~~~~~~~~~~
  127. Clicking menu over the !ClicBack icon will display a menu as shown 
  128. in figure 1. 
  129.  
  130. Info
  131. ~~~~
  132. Info will display information about your version of the program. The 
  133. Registered to field will show ***Unregistered *** or your name if you 
  134. have registered your copy.
  135.  
  136. Save
  137. ~~~~
  138. Save leads to a standard “Save as” dialogue box which enables you 
  139. to save the current settings to a configuration file.  The configuration 
  140. files have a file type of &326. The !ClicBack program can be started by 
  141. double clicking on a configuration file.  The program will be loaded 
  142. with the options from the configuration file. These files can be edited
  143. by hand if required, the syntax and details are at the end of this file.
  144.  
  145. Quit
  146. ~~~~
  147. Quit will exit !ClicBack, removing it from the computers memory.
  148. Clicking SELECT on the !ClicBack icon on the iconbar will display 
  149. the Setup Window shown in figure 3.
  150.  
  151.  
  152.                              <Figure 3>
  153.  
  154. This window displays the various settings available.
  155.  
  156. !ClicBack Setup Window
  157. ~~~~~~~~~~~~~~~~~~~~~~
  158. Backup Type
  159. ~~~~~~~~~~~
  160. The Backup Type popup menu allows you to choose the type of backup you 
  161. wish to perform. There are three backup types available.
  162.  
  163. Full Backup
  164. This type of backup backs up all the files on the source path to the 
  165. destination path. This is first type of backup that you should perform. 
  166.  
  167. Incremental Backup
  168. This type of backup backs up only those files which have been 
  169. created or modified since the last backup.The last backup maybe Full, 
  170. Incremental or Differential.  Therefore if you use Incremental backups
  171. you will need to use a different set of discs each time.  Do not use the
  172. same discs that you used for the Full backup as you will lose the
  173. first part of the backup when it is over written by the Incremental
  174. backup data.  
  175.  
  176. Differential Backup
  177. A differential backup backs up only those files that have been 
  178. created or modified since the last Full backup.  Therefore only
  179. the one set of Differential backup discs will be required and can
  180. be used for each Differential backup.  Once again do not use the
  181. same discs that you used for the Full backup as you will lose the
  182. first part of the backup when it is over written by the Differential
  183. backup data.
  184.  
  185.  
  186. Selective
  187. ~~~~~~~~~
  188. For this option it is necessary to explain basically how the program 
  189. works.
  190.  
  191. When you conduct a backup the program will compile a list of files 
  192. to backup.  Once the backup has been completed the program will store 
  193. the logfile in the Resources directory inside the !ClicBack application.  
  194. These logfiles are used as the basis for the Differential and Incremental 
  195. backup’s.  The program compiles a list then finds the difference 
  196. between the various files.  This method gets around the problem where 
  197. files are copied to the hard disk but have an older date/time stamp than 
  198. the last backup.  If the selective option is selected then the logfile will 
  199. not be stored in the resources directory.  I would recommend that you 
  200. use the selective option if you are backing up any directory other than 
  201. the root directory.
  202.  
  203. File Source
  204. ~~~~~~~~~~~
  205. The File Source specifies the directory that you wish to backup. 
  206. Dragging a directory or file to this icon will insert the full pathname of 
  207. that directory into the icon. If the object dragged is a file the inserted 
  208. path will be the parent directory.  Alternatively you can type the path 
  209. into this icon.
  210.  
  211.  
  212. Destination
  213. ~~~~~~~~~~~
  214. The Destination specifies where the backup data will be written to.  
  215. The destination path can be set in one of two ways. If the destination is 
  216. to floppy disks the destination drive is selected via the popup menu option. 
  217. If the destination is another hard disk then simply drag 
  218. the destination directory to the destination icon.Once again if the 
  219. dragged object is a file then the inserted path will be the parent 
  220. directory of the file. The two possible destinations are :
  221.  
  222.                   ADFS floppy disk
  223.                   Other
  224.  
  225. If the destination is to a floppy disk the program will prompt you for 
  226. disks as required. The program will also automatically delete all files 
  227. on the floppy disk and name the disk.  If the disk is not a RISCOS 800k 
  228. or 1.6M disk the program will prompt you to reformat it.
  229.  
  230. If the destination is “Other” the program will not delete any files or 
  231. attempt to name the disk.
  232.  
  233. Lists Popup Menu
  234. ~~~~~~~~~~~~~~~~
  235. This menu allows you to select which combination of the Include/Exclude
  236. lists you wish to use for the backup.
  237.  
  238. The Use Include List option allows you to specify a list of files or 
  239. directories to backup. Click on the Include option in the Misc menu to 
  240. display the Include window.You may drag files / directories into this 
  241. window to create a list of files to be backed up.
  242.  
  243. If this option is not selected then the contents of the Include list are 
  244. not used.
  245.  
  246. When the program is started it will check for the presence of the files 
  247. in the lists.  If the files are not found then the file/Directory will be 
  248. given the default icon of a directory.
  249.  
  250. Cancel
  251. ~~~~~~
  252. Clicking on the Cancel icon will discard any changes you have made 
  253. to the settings and reload the default settings.
  254.  
  255. Save
  256. ~~~~
  257. Clicking on the Save icon will save the current settings as the default 
  258. settings.
  259.  
  260. OK
  261. ~~
  262. Clicking on the OK icon will start the backup sequence.
  263.  
  264. Main Window Menu
  265. ~~~~~~~~~~~~~~~~
  266. Clicking menu over the main window will display the menu shown 
  267. in figure 4.
  268.  
  269.                              <Figure 4.>
  270. Info
  271. ~~~~
  272. Info will display information about your version of the program. The 
  273. Registered to field will show ***Unregistered *** or your name.
  274.  
  275. Options
  276. ~~~~~~~
  277. This menu entry leads to the following sub-menu
  278.  
  279. Include
  280. ~~~~~~~
  281. Clicking on this menu entry will display the Include File window. 
  282. Dragging files or directories to this window will include them into the 
  283. backup.  It is not necessary to include files or directories that are within 
  284. the source directory as these will be backed up automatically. The 
  285. Include list will only be used if the “Use Include List“ option is 
  286. selected.
  287.  
  288. Exclude
  289. ~~~~~~~
  290. Clicking on this menu entry will display the Exclude File window. 
  291. Dragging files or directories to this window will add them to the 
  292. Exclude List.  It is not necessary to exclude files or directories that are 
  293. not within the source directory as these will be excluded automatically.  
  294. The Exclude list will only be used if the “Use Exclude List” option is 
  295. selected.
  296.  
  297. You might wish to exclude every directory or file with a particular 
  298. name from the backup i.e. *.o to exclude all directories or files called 
  299. 'o'.  To do this simply press and hold the shift key and then drag the 
  300. object into the window.  Although it is possible to use this with the 
  301. include list a filename of *.o, for example, makes no sense and will be 
  302. ignored.
  303.  
  304. History
  305. ~~~~~~~
  306. Clicking on this menu entry will display the History Window as 
  307. shown below.
  308.  
  309. This window gives date and time that the backups were completed, 
  310. whether the backups were Selective or Non-Selective, backup type and 
  311. the time taken to backup. From time to time you may wish to delete 
  312. some of the entries from the History file. Pressing menu over this 
  313. window will display the following menu.
  314.  
  315. Only the bottom entry needs any explanation.  The Remove option 
  316. will delete the selected History file entries.  Individual entries may be 
  317. selected by clicking SELECT on the required entry.  Multiple entries 
  318. can be made by using ADJUST.
  319.  
  320. Password
  321. ~~~~~~~~
  322. This menu option leads to a dialogue box with two writable icons. Type
  323. your password into the top icon move to the second icon and retype the password.  
  324. When you press return or tab with the caret in the second icon
  325. the program will check that the two copies of the password are the same.
  326. It will then unshade the 'Set' icon and allow you to password protect
  327. the backup data.
  328.  
  329. The password must be at least two characters long and not more than eight 
  330. characters. The password is not stored with the backup data. It is therefore 
  331. important that you remember the password. The Password is also CASE 
  332. SENSITIVE i.e. KEY is not the same password as Key. If the backup 
  333. has been password protected the !Restore program will prompt you for 
  334. a password before the restoration of data starts, but has no means of 
  335. checking that the password is correct.
  336.  
  337. Compression
  338. ~~~~~~~~~~~
  339. This allows the user to set the amount of compression the program 
  340. will attempt. The permitted values are in the range 1 to 9 with 9 being 
  341. the maximum compression.The default value is 1 which provides the 
  342. best compromise for speed whilst maintaining an adequate amount of 
  343. compression.Setting this value to 9 will increase compression but will 
  344. increase the time taken for the backup.The program uses the same 
  345. amount of memory regardless of the compression level.
  346.  
  347. Verify
  348. ~~~~~~
  349. When Verify is selected the data that has just been written to the 
  350. destination file will be verified to ensure that the data was written 
  351. correctly.  If any errors are detected the data will be written again.  This 
  352. will slow down the backup considerably.
  353.  
  354. Don't Compress...
  355. ~~~~~~~~~~~~~~~~~
  356. Some types of file are already compressed such as archives, GIF or JPEG
  357. files etc.  Attempting to compress these files again might only save a
  358. few bytes, if anything, and therefore isn't really worth the extra
  359. processing time.  Selecting the menu option will open a window called
  360. "Don't Compress Filetypes".  Dragging a file into this window will display
  361. the file icon and the filetype in Hex beside it.  The program will not attempt
  362. to compress any of the specified filetypes.  This can produce significant time
  363. savings.
  364.  
  365. Disc detect
  366. ~~~~~~~~~~~
  367. This causes the computer to check for the presence on a new disc once
  368. every second.  If a new, formatted disc is found then the program
  369. will continue automatically.  If the disc is already part of the backup
  370. set then the program will do nothing. 
  371.  
  372. If you wish to check the contents of a disc before using it you will need to
  373. 'Pause' the backup BEFORE inserting the disc.
  374.  
  375. Whilst the computer is waiting for a disc you will notice that the disc
  376. drive light will flash every second.  It is perfectly safe to insert
  377. or remove a disc whilst the drive is doing this.
  378.  
  379. Backup Sequence
  380. ~~~~~~~~~~~~~~~
  381. Before starting the backup you should quit any other applications 
  382. that are currently running. The extra memory gained will speed up the 
  383. backup. Once you have ensured that the File source,  Destination,  
  384. backup type and other options are set correctly, you may start the 
  385. backup by clicking on the OK icon.
  386.  
  387. The first thing that happens during the backup sequence is a pre-backup
  388. pass of the File source. This builds a log file of all the files to 
  389. be backed up, and the amount of data. When the log  file is complete 
  390. the backup will start. If you are not backing up to floppy disks, the 
  391. backup will commence immediately. You can abandon the backup at 
  392. anytime by clicking on Abort.  There maybe a short delay before the 
  393. program acknowledges your request to abandon the backup especially 
  394. if the program is compressing a large file.
  395.  
  396. Backup to Floppy Disk
  397. ~~~~~~~~~~~~~~~~~~~~~
  398. If you are backing up to floppy disks you will be prompted to insert 
  399. the first floppy disk of the disk set.  After inserting the disk into the 
  400. drive click on OK or press return. The program will first check that
  401. the disk has been formatted and if not, will prompt you before formatting it.  
  402. The program will also prompt you to format any disk that is not a standard 
  403. RISCOS disk, i.e. MSDOS formatted disks.  Although the program 
  404. could use these disks there is no benefit in doing so, they hold less data 
  405. than the RISCOS equivalents and writing to these disks is much slower 
  406. than a native disk format. 
  407. The program will AUTOMATICALLY DELETE any files on the destination floppy.
  408. An estimate of the number of disks required and the estimation of 
  409. time left will be updated as each floppy disk is filled. The floppy 
  410. disks will also be named to reflect the backup type, date and disk 
  411. number i.e.
  412.  
  413.                              37F0105002
  414.  
  415. This indicates that the backup was started at minute 37.  The F shows that
  416. it was a Full backup, and the backup date was the 1st May and this is disc
  417. number 002. As the backup progresses you will be prompted to insert floppy 
  418. disks as they are required. You can abandon the backup at any time by 
  419. clicking on Abort.
  420.  
  421. Backup progress
  422. ~~~~~~~~~~~~~~~
  423. During the backup, information is displayed in the ClicBack Status 
  424. window. Figure 5.
  425.  
  426.                              <Figure 5>
  427.  
  428. Name
  429. Displays the pathname of the file currently being processed.
  430. Size
  431. Displays the original size of the file.
  432. Done
  433. Shows the percentage of the backup completed.
  434. Disk 
  435. This displays the current disk number.
  436. of ~
  437. Displays an estimate of the number of disks required. Updated during 
  438. the backup.
  439. Estimated Time left 
  440. Displays an estimate of the time remaining for the backup to including 
  441. delays in inserting floppy disks.
  442. Compression
  443. Displays the percentage of disk space saved.This value might be 
  444. negative when the program is unable to compress the input files.This 
  445. negative value arises because !ClicBack writes some internal 
  446. information with the backup data.
  447.  
  448. The backup can be aborted at any time by clicking on the Abort icon.  
  449. There may be some delay whilst the current data chunk is compressed.
  450.  
  451. You might notice that the amount of data backed up is not the same  
  452. as the amount of used space on your hard disk.This is due to the filing 
  453. systems allocating space for directory entries.  Each directory will take 
  454. one block of your hard disk.Therefore if the block size is 1024 bytes 
  455. each directory will take up 1k of disk space.The backup program only 
  456. needs the date/time stamp of the directory to recreate it on restoring the 
  457. data.
  458.  
  459. !ClicBack now supports filenames of up to 56 characters in length as used
  460. by Jason Tribbeck's !Longfiles.  Because !Longfiles is basically an extension
  461. of the operating system you will need to ensure that !Longfiles has been installed
  462. prior to restoring your data. 
  463.                                 Restore
  464.                                 ~~~~~~~
  465. !Restore is copied to the first disc in a full backup.  If you are using a
  466. Differential or Incremental backup then it is assumed that it will form
  467. part of a full backup set and that a copy of !Restore would have been copied 
  468. to the first disc in the full backup set.  This is done to save disc space
  469. on Incremental or Differential backups.
  470.  
  471. Double clicking on the !Restore icon will load the application onto the iconbar. 
  472. Clicking on the icon will open the programs main window.
  473.  
  474.  
  475.                                <Figure 6>
  476.  
  477. The File Source and Destination icons will contain the default paths 
  478. for the restore.These are obtained from a header within the BackData 
  479. file.The destination will be the same as the source for the original 
  480. backup.
  481.  
  482. If you wish to restore the data to a different directory or drive then 
  483. either drag the destination directory (or a file from that directory) into 
  484. the destination icon or press menu over the window and drag the save 
  485. icon from the destination submenu to your selected directory.
  486.  
  487. Main Window Menu
  488. ~~~~~~~~~~~~~~~~ 
  489. The menu has the following options.
  490.  
  491. Info
  492. Info will display information about your version of the program. The 
  493. Registered to field will show ***Unregistered *** or your name.
  494.  
  495. Source
  496. The program expects to find the backup data file in the same 
  497. directory as the !Restore program. If the program can not find the 
  498. backup data an error will be displayed.
  499.  
  500. When the program starts it will read certain details about the backup 
  501. from the backup data such as source and destination.
  502.  
  503. Destination
  504. This will bring up a standard save as box. Dragging the file icon to 
  505. the destination directory will insert the full path into the destination 
  506. icon.You can also select the destination directory by dropping the 
  507. selected directory onto the destination icon. This will also insert the full 
  508. path into the destination icon.If you drop a file onto the destination icon 
  509. the parent directory will be inserted into the icon.
  510.  
  511. Password
  512. This menu option leads to a writable icon into which you will have 
  513. to enter the password if the backup is password protected. The 
  514. Password is also CASE SENSITIVE i.e. KEY is not the same password 
  515. as Key.  If the backup has been password protected but you do not enter 
  516. a password before starting the restore the program will prompt you for 
  517. a password before the restoration of data starts, but has no means of 
  518. checking that the password is correct.
  519.  
  520. Clicking on OK will start the restore process.  The program will 
  521. display the status window which is identical to !ClicBack's status 
  522. window.
  523.  
  524.  
  525.                              Retrieve
  526.                              ~~~~~~~~
  527. Retrieve is copied to the last disc in the backup sequence along with a
  528. file which holds the information that !Retrieve needs in order to
  529. locate and restore the selected object.
  530.  
  531. This program is used to restore single files, directories or 
  532. applications.  The program is loaded by double clicking on 
  533. the !Retrieve icon.  Clicking on the iconbar will open the programs 
  534. main window. 
  535.  
  536. Figure 7
  537.  
  538. Main Window
  539. ~~~~~~~~~~~
  540. The main window has a writable icon for you to specify the name of 
  541. the file/directory or application which you wish to restore.  There is a 
  542. group of three icons which enables you to select what type of object 
  543. you are looking for. The ‘Wildcard’ icon will extend the window to 
  544. show the available wildcards.
  545.  
  546. The wildcards are as follows:
  547. Digit #     - Matches any characters 0-9
  548. Any .       - Matches any single character
  549. Not ~       - Matches any character except the character specified.
  550. Alphanum @  - Matches any alphanumeric character a-z, A-Z, 0-9 or _.
  551. Set []      - [abc] matches any of the characters a, b, or c.  
  552.               Note that a set is always case sensitive.
  553. Normal \    - \s will match the character s even if s is 
  554.               a special character.
  555. 0 or more * - *c matches 0 or more occurrences of c, where c is any of 
  556.               the simple character patterns listed above.
  557. 1 or more ^ - ^c matches 1 or more occurrences of c, where c is any of 
  558.               the simple character patterns listed above.
  559.  
  560. Clicking on Run or pressing return will start the search.  If the search 
  561. finds more than fifty objects that matches the search pattern then an 
  562. error will be generated prompting you to narrow the search pattern to 
  563. reduce the number of possible matches and only the first 50 matches 
  564. will be displayed.
  565. The matches will be displayed in a separate window called the 
  566. search window as shown below.  This shows the result of searching for 
  567. objects called unique with the files and applications options set.  To 
  568. restore a selected file simply drag it from this window to the directory 
  569. you wish to restore the file to.  The program will prompt you to insert 
  570. the required disks and proceed as for a normal restore.  Several objects 
  571. can be selected from the Matches window by clicking select on the first 
  572. object and using Adjust to select subsequent objects. 
  573.  
  574. Figure 8
  575. History
  576.  
  577. 1.00
  578. Not so much of a hard disk backup program but a hard disk cleaner. 
  579. Managed to wipe every other file on a hard disk. If it wasn’t for a bug I 
  580. would have had the lot. sorry Buck!
  581.  
  582. 2.01
  583. A working Multi-tasking backup program which I was reluctant do 
  584. release into the world incase there where any bugs that I had not found 
  585. despite extensive testing.Finally plucked up the courage to release it 
  586. and was pleased by the stability of the program.
  587.  
  588. 2.06
  589. Fixed the minor bugs that have been reported and made some 
  590. improvements that have been suggested by users e.g. Pause, better 
  591. compression ratio etc.
  592.  
  593. 2.50
  594. Implemented the Difference Algorithm instead of using just  the date 
  595. time stamp.  Fixed a bug that prevented !ClicBack from formatting 
  596. high density disks (couldn’t test this on my old A3000).  Added the 
  597. compression level to the options file.  Sorted out !Restore to only close 
  598. the destination window.  Fully tested on the RiscPC.
  599.  
  600. 2.51
  601. Fixed a bug that missed the last character off the filename when 
  602. using !Retrieve.
  603.  
  604. 2.52
  605. Added detection of native RISCOS format disks. !ClicBack will now 
  606. only accept D/E or F formatted disks.
  607.  
  608. 2.53
  609. Fixed a bug that prevented !Retrieve restoring any single file that 
  610. was split across two or more disks.
  611.  
  612. 2.54
  613. Removed “Unstamped” option as it has been made redundant since 
  614. the release of version 2.50. Also fixed a bug that would cause 
  615. !ClicBack to crash if there were no files to backup.
  616.  
  617. 2.60
  618. Removed all restrictions on the demonstration version of the 
  619. programs and decided to use a key file for registered users. (Thank you 
  620. David Holden).  Included and Shift-Drag option for excluding files to 
  621. exclude all object with a given leafname.  Finally tracked down the
  622. problem with !Restore asking for a disk beyond the last disk in the
  623. backup set.
  624.  
  625. 2.70
  626. Following several phone calls from David Holden I have changed a number
  627. of things in this version and fixed a problem with ArcFS and SparkFS which
  628. would cause !ClicBack to crash when ArcFS or SparkFS ran out of memory.
  629. The problem was caused by the above two programs intercepting calls to
  630. OS_GBPB and OS_File and changing the object type returned from these calls
  631. from 3 (Image files) to 2 (directory).  !ClicBack therefore thought that
  632. it was recursing through a directory structure and wasn't expecting another
  633. program to deny access to a file because it was out of memory.  Anyway it's
  634. fixed now.  Also changed the following:
  635.   1.  User interface - I think this gives a cleaner, less cluttered feel
  636.       to the program.  I know the popup menus do not appear in quite the
  637.       right positions but I cannot find a way around in in Risc_OSLib.
  638.   2.  Changed format of configuration files.  These are now in a human-readable
  639.       format, the syntax of which can be found elsewhere in this manual.
  640.   3.  Added a means for the user to specify which files not to compress.  This
  641.       can make backing up data a lot quicker as the program no longer has to
  642.       work so hard in order to same a few k's compressing pre-compressed files.
  643.   4.  Re-coded a large portion of the programs, saving quite a bit of space
  644.       and, hopefully making it a bit quicker.
  645.   5.  !ClicBack now recognises image files and will back them up as a
  646.       single (sometimes large) file (DOS partition files).
  647.   6.  Cleared the bug that would cause the program to sometimes crash when
  648.       you selected History.  I still don't know why it did it but i've
  649.       recoded this and the problem (appears) to have vanished.  The
  650.       text justification of the history file does appear a bit strange on
  651.       a RiscPC if you are using an outline font for the desktop.
  652. 2.71
  653. Fixed a problem with the lists that would cause the program to crash if
  654. the user selected all items and then selected remove.
  655. Also changed the saving of options files to save the numerical filetype
  656. and not the string filetype as this could cause problems if the textual
  657. filetype was not know to the system when the options file was loaded.
  658.  
  659. 2.80
  660. Replaced the deletion routines for ADFS floppy discs with 'Quick Format'
  661. routines.  This can save a lot of time if the backup discs have a lot
  662. of files on them.
  663.  
  664.  
  665. Future Plans
  666. I intend to make the restore program more visually based. i.e. show a 
  667. directory tree and allow you to point and click to specify the files to 
  668. restore.  As usual the problem is time.
  669.  
  670. Improve the search facilities to incorporate fuzzy matching. i.e. a 
  671. search for directtory would find directory.
  672.  
  673. And the normal improvement ..... speed. I hope to double the 
  674. program speed of the backup eventually. The speed of restoration is 
  675. already pretty impressive for large files.
  676.  
  677. known bugs
  678. None at the moment.... and as they say, it's not a bug it's just an undocumented
  679. feature!!!!
  680.  
  681. Thanks To
  682. Dominic Symes for THE text(?) editor !ZAP. If you haven’t got a 
  683. copy get one!
  684. Martin Ebourne and Bryan Scattergood for the C/Assembler modes in !ZAP.
  685. Acorn for there C Compiler (and computer).
  686. Jonathan Marten for the inspiration to start this program. (UAP ?)
  687. Chris Taylor for the suggestions on improving the program and encouragement
  688. My wife for being a computer widow.
  689. David Holden for persuading me to remove all restrictions on the program and
  690. for his advice and suggestions regarding !ClicBack's operation.
  691. And all registered users of the program. 
  692.  
  693. Configuration File Syntax
  694. ~~~~~~~~~~~~~~~~~~~~~~~~~
  695. !ClicBack uses a very simple script language for its configuration files.
  696. The language consists of 15 tokens.  The tokens are as follows:
  697.  
  698. on      -     These are used in conjunction with the other tokens to specify
  699. off           if an option is switched on or off.
  700.  
  701. The simple on/off options are as follows.
  702. #selective     on|off               Turns the selective option on or off.
  703. #use_exclude   on|off               Informs the program that you wish to use the exclude list.
  704. #use_include   on|off               Informs the program that you wish to use the include list.
  705. #verify        on|off               Turns the verify option on or off.
  706.  
  707. The following options require either a string or number parameter.
  708.  
  709. #compression    1..9                Sets the level of data compression to a value between 1 and 9.
  710. #drive_number   0..3|255            Used to indicate which floppy disk drive you wish to backup to.
  711.                                     If the destination is another hard disk then this value should
  712.                                     be set to 255.
  713.  
  714. #backup_type   full|diff|incr       Allows you to specify the type of backup you only need to give 
  715.                                     the first four characters of the backup type.
  716.  
  717. #source        path                 Set the source path for the backup.
  718. #destination   path                 Set the destination for the backup.
  719. #include       pathname             Add the object to the include list.
  720. #exclude       pathname             Add the object to the exclude list.
  721. #dont_compress &filetype            Add the file type to the list of filetypes not to compress.
  722.  
  723. There is one token which is currently unused.This option will be added in the future.  
  724. The minimum size for file compression is currently set in the messages file 
  725. inside the !ClicBack application.
  726.  
  727. #auto_disk_detect on|off            Turns disk changed polling on or off.
  728. #min_size         number            Set the minimum file size for compression.
  729.  
  730. Example 1 script:
  731. #source SCSI::Backup.$.Test.UTILITIES3
  732. #destination SCSI::Backup.$.Test
  733. #drive_number 255
  734. #backup_type full
  735. #compression 1
  736. #verify off
  737. #selective off
  738. #use_include off
  739. #use_exclude off
  740. #dont_compress &3FB
  741. #dont_compress &DDC
  742. #dont_compress &C85
  743.  
  744. Example 2 script
  745. #source SCSI::Backup.$.Test.UTILITIES3
  746. #destination ADFS::0.$
  747. #drive_number 0
  748. #backup_type full
  749. #compression 9
  750. #verify off
  751. #selective off
  752. #use_include on
  753. #use_exclude on
  754. #exclude SCSI::Main.$.EagleM2.!TakeTwo
  755. #exclude *.Scrap
  756. #include SCSI::Main.$.EagleM2.!AudioWrks
  757. #dont_compress &3FB
  758. #dont_compress &DDC
  759. #dont_compress &C85
  760.